home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / pkins710.arc / PKINSERT.NEW < prev    next >
Text File  |  1992-01-02  |  20KB  |  481 lines
  1.  
  2.      PKInsert Version History in Reverse Order                 Page 1  of 8
  3.      ──────────────────────────────────────────────────────────────────────
  4.  
  5.                                   Version 7.10
  6.                            Released January 1st, 1992
  7.  
  8.      As new  features where  developed for PKInsert,  it was  chewing up an
  9.      increasing amount of  memory.  This came from  using Arrays which kept
  10.      positions and archive information in memory.  Although fast, it is not
  11.      practical for large applications.
  12.  
  13.      Prompted by WWIV SysOps, which have very little memory to work with, I
  14.      started re-writing  large sections of  PKInsert.  Version  7.10 is the
  15.      result.  Almost  all Arrays have  been eliminated  and the information
  16.      they once contained is now  handled by temporary database files.  Each
  17.      archive's information is held within a 100 byte record.
  18.  
  19.      Not only does  this new structure improve  memory requirements, but it
  20.      also eliminates previous wild-carding restrictions!
  21.  
  22.      Added a  new ARJ parameter  for inserting comments  only.  If PKInsert
  23.      V7.00 was configured to insert an  archive comment, but not add files,
  24.      ARJ would add all the files in  a directory to the archive.  This is a
  25.      default  action  by ARJ  and  could  not be  countered  without adding
  26.      another set of ARJ parameters to the configuration file.
  27.  
  28.      Thanks to our beta test team:
  29.  
  30.          Skoal Bandit   Howell
  31.          John Theos     Montreal Quebec
  32.          Edward Huzyk   Pierrefonds Quebec
  33.          Denis Grenier  Repentigny Quebec
  34.          Shawn Rausch   Dublin Ohio
  35.          Troy Hunt      Cincinnati Ohio
  36.  
  37.      And  special  thanks  to  John  Eason  of  Crofton  Maryland  for  his
  38.      suggestions, and bug  reports.  Without his  input, PKInsert might not
  39.      have been so complete.
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.      
  61.  
  62.      PKInsert Version History in Reverse Order                 Page 2  of 8
  63.      ──────────────────────────────────────────────────────────────────────
  64.  
  65.                                   Version 7.00
  66.                           Released December 4th, 1991
  67.  
  68.      I'm very proud of  this release.  Although the  amount of new features
  69.      may not seem  lengthy, it took me  several days to  work them in 'just
  70.      right'.  By no means is this the end of the PKInsert saga, I'm already
  71.      planning a few additions for V7.00 and a major one for V8.00.
  72.  
  73.      New Features
  74.      ~~~~~~~~~~~~
  75.      I've re-worked the entire tagline  structure.  Version 7.00 will still
  76.      pick up taglines from Versions 6.xx.
  77.  
  78.      HANDLING OF  ZIP, LZH,  AND ARJ  ARCHIVES!  This  was the  hole reason
  79.      behind  Version  7.00.  You  really  don't  have to  worry  about what
  80.      standard your feeding PKInsert (or which types are nested).
  81.  
  82.      Since Version 6.00,  PKInsert has always  recognized archives by their
  83.      unique  signatures.    This  prevents  nested   archives  from  hiding
  84.      themselves  under  different  names.   Following  are  the  signatures
  85.      Version 7.00 uses to distinguish the different compression types.
  86.  
  87.                    Beginning of File      End of File
  88.                    ====================   ===========
  89.      PKZIP/UNZIP   50 4B 03 04 .. .. ..   .. .. .. ..
  90.              LZH   .. .. 2D 6C 68 .. 2D   .. .. .. ..
  91.              ARJ   60 EA .. .. .. .. ..   60 EA 00 00
  92.          ARJ-SFX   4D 5A .. .. .. .. ..   60 EA 00 00
  93.  
  94.  
  95.      **********************************************************************
  96.      WARNING:  PKInsert V7.00 will NOT  read or convert configuration files
  97.      of older  versions!  Although  this makes  upgrading a  bit longer, it
  98.      saves on code size.
  99.      **********************************************************************
  100.  
  101.                                   Version 6.62
  102.                           Released November 24th, 1991
  103.  
  104.      Pkinsert now calls Pkzip/unzip and Scan  with full path names.  It was
  105.      reported that archives containing Pkzip/Pkunzip (.Exe/.Bat/.Com) where
  106.      being executed instead of the systems own Pkzip/Pkunzip.Exe.
  107.  
  108.      Special thanks  to John Eason  of Crofton Maryland,  USA for reporting
  109.      this rather sensitive bit of information.
  110.  
  111.                                   Version 6.61
  112.                           Released November 20th, 1991
  113.  
  114.      Premature EOF  characters (Ascii  26) in  archive comment  would cause
  115.      system freeze.
  116.  
  117.                                   Version 6.6
  118.                           Released November 14th, 1991
  119.  
  120.      
  121.  
  122.      PKInsert Version History in Reverse Order                 Page 3  of 8
  123.      ──────────────────────────────────────────────────────────────────────
  124.  
  125.  
  126.      New Features
  127.      ~~~~~~~~~~~~
  128.      Auto-park cursor at  column/row 1/1 for  clearer displays when running
  129.      in DESQview window.
  130.  
  131.      Added logic to compare previous history taglines against each other to
  132.      filter out duplicates.
  133.  
  134.      Eliminated  the  node number  configuration  value which  was  used to
  135.      create  work directories.   This new  version,  using a  random number
  136.      seed,  sequentially  seeks  an available  directory  name   (it always
  137.      bothered me to keep track of which node number I was using).
  138.  
  139.      Also eliminated the  configurable Network delay  retry attempts value.
  140.      It's now hard-coded for 5 retries.
  141.  
  142.      Added display of errorlevel code on exit.
  143.  
  144.      Pound (#) signs within TEXT ENTRIES are replaced with the current node
  145.      number (except in the Tagline field).  Node numbers are retrieved from
  146.      the Pcboard.Sys  and/or Door.Sys  file in  the current  directory.  If
  147.      none is available, the node number defaults to zero (0).
  148.  
  149.          Example:
  150.  
  151.          Config Value   D:\PKINSERT\NODE-#.LOG
  152.          Becomes        D:\PKINSERT\NODE-0.LOG (default value)
  153.  
  154.      (/L)OG PATH PARAMETER IS NO LONGER VALID.  Using the above feature, it
  155.      is possible to customize the log file names for every node.
  156.  
  157.      Those  wishing  to  retain  ONE  configuration  file  in  a MULTI-USER
  158.      environment, and  do not  have Pcboard.Sys  and/or Door.Sys available,
  159.      you may specify node numbers using the (/N)ode parameter.
  160.  
  161.      Bugs Squashed
  162.      ~~~~~~~~~~~~~
  163.      If  file swapping  went  past two  on a  @filelist  it would  create a
  164.      conflict with another open file.   Fixed by having the compiler assign
  165.      free file handles instead of assigning them myself.
  166.  
  167.                                   Version 6.5
  168.                           Released October 22nd, 1991
  169.  
  170.      Refer to  the Pkinsert.Doc  manual for  upgrade instructions.  Special
  171.      thanks to John Theos from AAxiss BBS for Beta testing.
  172.  
  173.      New Features
  174.      ~~~~~~~~~~~~
  175.      Errorlevel 113 exit for 'Unknown Configuration File Format'.
  176.      Errorlevel 114 exit for 'Unable to Locate File' (see next feature).
  177.  
  178.      Depending on  the configuration  options chosen,  Pkinsert will verify
  179.  
  180.      
  181.  
  182.      PKInsert Version History in Reverse Order                 Page 4  of 8
  183.      ──────────────────────────────────────────────────────────────────────
  184.  
  185.      the  location of  the  executable it  will  need (Pkzip,  Pkunzip, and
  186.      Scan).   Since Pkinsert  moves  around quite  a  lot (keeps  DOS shell
  187.      commands short), it  will ONLY search  Pathed directories.  Failure to
  188.      locate a needed file will cause Pkinsert to end with an error.
  189.  
  190.      If  a  Pcboard  V14.5a  Pcboard.Sys or  Door.Sys  file  exists  in the
  191.      start-up directory, Pkinsert will log  the node number, user name, and
  192.      bps rate (and city if Door.Sys  is available).  Pkinsert will also use
  193.      the node number  to create it's work  directory, overriding a previous
  194.      node number  value.  Node number  priority sequence  follows (least to
  195.      most):
  196.  
  197.          Configuration File
  198.          Environment Variable
  199.          Command Line
  200.          Pcboard.Sys
  201.          Door.Sys
  202.  
  203.      Improved the standard log file output.   Now includes many of the same
  204.      results as the Fail and Pass log files.
  205.  
  206.      I finally had time  to incorporate a feature  which had been pinned on
  207.      my cork board  for quite a while,  called "Tagline History".  PKinsert
  208.      will keep  a record  of past  system Taglines  in the  archive comment
  209.      screen.  SysOps  and Users  can then  track the  trajectory an archive
  210.      took through various systems.  This  feature is enabled by setting the
  211.      "Number of Taglines to Keep :"  bigger than zero.   Pkinsert must also
  212.      Test, Delete,  or Scan  in order to  pick up  the tagline information.
  213.      When disabled, PKinsert will clear any old Histories.
  214.  
  215.      Note -   Pkinsert  recognizes   taglines  through  a   unique  4  byte
  216.               signature.  Other utilities  wishing to be  compatible or use
  217.               Pkinsert's  tagline info,  should use  this standard.   The 4
  218.               byte signature  comes immediately  after a  Cr/Lf sequence in
  219.               the archive comment.
  220.  
  221.               Signature (in Hex):  FF 08 xx FF {Tagline}
  222.  
  223.      Pkinsert will not delete Pkzip.Exe and Pkunzip.Exe from any file named
  224.      Pkz###.Exe (where ### is  bigger or equal to  110).  You can therefore
  225.      enter Pkzip.Exe and Pkunzip.Exe as filespecs in the Pkinsdel.Lst file,
  226.      without worrying about killing Pkzip upgrades.  :)
  227.  
  228.      Previously, if  disk space  ran short  (as specified  in configuration
  229.      file), an archive would be renamed to .Err.  In Version 6.5 an archive
  230.      will be  renamed to  .Hld (configurable) if  a file  measures 0 bytes,
  231.      disk space runs out, or the file is not a valid archive (Rename option
  232.      must be enabled).
  233.  
  234.      Another  new  feature is  the  '@Filelist' command  line  option.  Any
  235.      filename preceded  with an  '@' symbol will  be expected  to contain a
  236.      list of files to  process.  Each file specification  in this list must
  237.      occupy a separate line.  Wildcarding is accepted.
  238.  
  239.  
  240.      
  241.  
  242.      PKInsert Version History in Reverse Order                 Page 5  of 8
  243.      ──────────────────────────────────────────────────────────────────────
  244.  
  245.          ie.  Files.Lst
  246.               ~~~~~~~~~
  247.               D:\Arc\*.Zip
  248.               Archive.Zip
  249.               E:\Main\Files\Backup.Z??
  250.               \Work\A*.Tmp
  251.  
  252.          You may also use a combination of directory pipes.
  253.  
  254.          ie.  C:\>Dir D:\Arc >>Files.Lst
  255.               C:\>Dir E:\Main\Files\*.Zip >>Files.Lst
  256.  
  257.          Instead of entering  redundant directory information  you can tell
  258.          Pkinsert to change  drives and directories.   Use the 'Cd' command
  259.          followed by a space, or back-slash, and the directory name.
  260.  
  261.          ie.  Files.Lst
  262.               ~~~~~~~~~
  263.               Archive.Zip
  264.               Cd\Arc
  265.               *.Zip
  266.               Cd E:\Main\Files
  267.               Good*.Zip
  268.               Bad*.Old
  269.               Ugly*.$$$
  270.               Cd\C:\Temp
  271.               Backup.Z??
  272.  
  273.          These techniques can be used together for greatest versatility.
  274.  
  275.          Note -    Normal  array size  boundaries  apply ONLY  to wildcards
  276.                    within this  list.  There is  NO LIMIT to  the amount of
  277.                    filespecs contained  in the  file list.   If you  have a
  278.                    directory of several  thousand archives you  could use a
  279.                    command sequence along these lines:
  280.  
  281.                    C:\>Dir J:\Uploads\*.Zip >>Files.Lst
  282.                    C:\>Pkinsert @*.Lst
  283.  
  284.                    Wildcarding is also acceptable for filelist names.
  285.  
  286.      Bugs Squashed
  287.      ~~~~~~~~~~~~~
  288.      Virus Comment files where not being added to the extended fail log.  I
  289.      was using an "AND" where it should have been "OR".
  290.  
  291.      Redundant CR/LF sequences where being added under odd circumstances.
  292.  
  293.                                   Version 6.4
  294.                          Released September 22nd, 1991
  295.  
  296.      Set maximum  file read  length to 8k.   This solves  a string overflow
  297.      problem reading an  extremely large capture  file (created by shelling
  298.      to  Pkzip).   In  cases  where the  limit  is  exceeded,  an ///EOI///
  299.  
  300.      
  301.  
  302.      PKInsert Version History in Reverse Order                 Page 6  of 8
  303.      ──────────────────────────────────────────────────────────────────────
  304.  
  305.      (end-of-input) marker  will be  displayed.  This  has no  other effect
  306.      than limiting the amount of text scrolled on the screen.
  307.  
  308.      In order  to properly link  with other PCBoard  archive utilities, the
  309.      handling  of the  Extended Pass  and Fail  logs has  changed.  Details
  310.      follow.
  311.  
  312.          If an Extended Pass log  already exists, Pkinsert will rename this
  313.          log to Fail before appending it's own Fail report.
  314.  
  315.          Ie.  The  archive has  passed test  #1 which  created Pcbpass.Txt.
  316.               Then comes  Pkinsert (test  #2) and  the archive  fails.  The
  317.               Pcbpass.Txt  from  test  #1  is  renamed  to  Pcbfail.Txt and
  318.               Pkinsert appends it's report.
  319.  
  320.          If an Extended Fail log already  exists, it will be used to append
  321.          the Pass or Fail reports.
  322.  
  323.          Ie.  The archive could  fail test #1 but  pass Pkinsert (test #2).
  324.               In this case Pkinsert would append it's Pcbpass.Txt report to
  325.               the already existing Pcbfail.Txt log.
  326.  
  327.          Batch files should  therefore start with deleting  any old Pass or
  328.          Fail logs.  Otherwise Pkinsert will simply append it's reports.
  329.  
  330.                                   Version 6.3
  331.                           Released September 8th, 1991
  332.  
  333.      Pkinsert will recognize and process self-extracting Zips.
  334.  
  335.      File reading and swapping from disk was unbearable.  It turns out that
  336.      for every record accessed,  the last position within  a file was being
  337.      lost.  I have to apologize to everyone for this one ...
  338.  
  339.      When renaming was enabled and Pkinsert ran out of work space (or other
  340.      disk  related errors),  it would  exit  without renaming  the archive.
  341.      Pkinsert will now  rename archives to  .Err on these  occasions.  In a
  342.      batch  file  you  could  move these  .Err  files  to  a  directory for
  343.      re-processing under supervision.
  344.  
  345.      If  a nested  archive was  corrupt and  file renaming  was set  to No,
  346.      Pkinsert wouldn't clean up it's work directories.
  347.  
  348.      After extracting  nested archives, Pkinsert  wouldn't kill  them as it
  349.      was supposed to.
  350.  
  351.                                   Version 6.2
  352.                             Released August 10, 1991
  353.  
  354.      Reason for Upgrade
  355.      ~~~~~~~~~~~~~~~~~~
  356.      Matthew  Cooley  reported  an  incompatibility  problem  with  the new
  357.      PCBoard V14.5a (Beta) features.
  358.  
  359.  
  360.      
  361.  
  362.      PKInsert Version History in Reverse Order                 Page 7  of 8
  363.      ──────────────────────────────────────────────────────────────────────
  364.  
  365.      New Features
  366.      ~~~~~~~~~~~~
  367.      /D       Command line option.  Path to Pcb upload description file.
  368.      /TEST    Command line option.
  369.  
  370.      Zero byte file errorlevel code 112.
  371.      Standard tagline signature developed.  In HEX:  FF 08 xx FF <tagline>.
  372.  
  373.      Bugs Squashed
  374.      ~~~~~~~~~~~~~
  375.      If a virus was found and rename was disabled, Pkinsert would not clean
  376.      it's work directories.
  377.  
  378.                                   Version 6.1
  379.                             Released August 2, 1991
  380.  
  381.      Split code from 3 to 5 modules.
  382.  
  383.      Pkinsert will display any size status file.  V6.0 was limited to 6k.
  384.  
  385.      If Pass/Fail  extended logs  exist, Pkinsert  will delete  them before
  386.      creating a new one.  This saves 2 lines in the Pcbtest.Bat file.
  387.  
  388.      Process error codes from Add and  Delete functions.  They are the ones
  389.      which can report if archive is read-only.
  390.  
  391.      Clean-up work directories before Add and Delete functions.  This gives
  392.      Pkzip a bit more room to create it's work file.
  393.  
  394.      Check files for  unique 4 byte  Zip signature.  This  is more reliable
  395.      than  using file  name  extensions.  No  matter  what name  an archive
  396.      carries, Pkinsert will test it.
  397.  
  398.      New Errorlevel code 111 for illegal archive compression used.
  399.  
  400.      Pkinsert code stands at  2,461 lines in five  Quick Basic V4.5 modules
  401.      and 108,814 bytes compiled.
  402.  
  403.                                   Version 6.0
  404.                              Released July 25, 1991
  405.  
  406.      There's been so many  features added, I can't  remember them all.  The
  407.      following where the major ones.
  408.  
  409.      Total revamp of the configuration module.
  410.      Pkinsert will process `nested' archives.
  411.      Verbose log files based on results.
  412.      Configurable disk swapping.
  413.      Exit with Dos error levels.
  414.      etc.
  415.  
  416.      The current code stands at 2,260 lines in Quick Basic V4.5.
  417.  
  418.      Special  thanks   to  Steve  Greenspon,   aka  Doodle   Bug,  for  his
  419.  
  420.      
  421.  
  422.      PKInsert Version History in Reverse Order                 Page 8  of 8
  423.      ──────────────────────────────────────────────────────────────────────
  424.  
  425.      suggestions,  testing, and  listening to  me rant  and rave  about the
  426.      latest sub or function.  (grin)
  427.  
  428.                                   Version 5.1
  429.                             Released April 27, 1991
  430.  
  431.      Fixed an incompatibility problem with COUNTRY.SYS.  Thanks to Yan Wolf
  432.      from Top 50  BBS in Paris, France  for his help  in tracking down this
  433.      problem.
  434.  
  435.                                   Version 5.0
  436.                             Released March 13, 1991
  437.  
  438.      10k Smaller and much faster!  New features include ...
  439.  
  440.      - Random work directory names.
  441.      - 0 byte files are no longer processed.
  442.      - Complete activity logging to disk.
  443.      - All options can be toggled on or off.
  444.      - Configuration path may be entered by environment variable or command
  445.        line.
  446.      - Various configuration file names may be used.
  447.      - PKinsert will change  drives and directories  as it handles archives
  448.        for shorter DOS commands.
  449.      - PKinsert may add the virus scanner version to the archive comment.
  450.      - Compatible with  Digital Research  DOS 5.0  (actually, this  is what
  451.        prompted this new release).
  452.  
  453.                                   Version 4.02
  454.  
  455.      Fixed the  colours in  PKinserts logo.   Also fixed  a variable  I had
  456.      forgotten about.  PKinsert will now process numerous file specs again!
  457.      <Grin>.  PKTMP environment variable is now external.
  458.  
  459.                                   Version 4.00
  460.  
  461.      PKinsert now works  with DOS4! ;-)  Corrupted  archives are caught and
  462.      renamed.   Virus checking  is also  possible using  McAfee Associates'
  463.      SCAN.EXE program.  Work  drive can be  selected for quicker processing
  464.      on  a RAM  Drive.   Configuration is  now  internal.  No  more messin'
  465.      around with a  word processor.  And  last but not  least PKinsert goes
  466.      COLOUR!
  467.  
  468.                                   Version 3.20
  469.  
  470.      Added  support  for  DOSv4.0.    Uses  prodoor's  TAGLINE  environment
  471.      variable.  Will now skip the archive test if set to [N]o.
  472.  
  473.                                   Version 3.1
  474.  
  475.      Got rid of a few bugs.  The timer feature in v3.0 wasn't working and I
  476.      got  rid of  it.   Also shortened  much  of PKinsert's  output.  Error
  477.      trapping is also much improved!  Let's hope it won't need it.  <Ugg>
  478.  
  479.  
  480.      
  481.